home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 98 / Skunkware 98.iso / src / net / bind-contrib.tar.gz / bind-contrib.tar / contrib / doc / README < prev    next >
Text File  |  1996-10-25  |  3KB  |  91 lines
  1.  
  2. /*
  3. ** Distributed with 'doc' Version 2.1.1 from Defense Information
  4. ** Systems Agency (DISA).  5/27/95
  5. */
  6.  
  7. UPDATED RELEASE: 2.1.1 (5/27/95)
  8.  
  9. Added code to handle more robustly parent (delegating) domains that
  10. are not one level up from the domain being tested.
  11.  
  12. Added code to force entire domain string to be all lower case, since
  13. the DNS is not case-sensitive (and keeping the case caused some
  14. comparisons to fail).
  15.  
  16. =====================================================
  17.  
  18. UPDATED RELEASE: 2.1 (2/16/95)
  19.  
  20. Took over maintenance of DOC from previous authors.
  21.  
  22. Added code to do the equivalent of a "sort | uniq" on the NS records
  23. returned by dig.  Otherwise, the ADDAUTH option of recent versions of
  24. BIND could return a set of nameservers in the DATA section as well as
  25. the AUTHORITY section, and unnecessary checking would be performed.
  26.  
  27. =====================================================
  28.  
  29. UPDATED RELEASE: 2.0.1 (9/12/90)
  30.  
  31. Includes fixes for two portability bugs:
  32.  
  33.   1) On some systems (e.g. SunOS 4.1), the shell exit code is an unsigned
  34.      8 bit value.  This differs from the development environment where
  35.      negative values were also returned.  This affected values
  36.      returned by auxiliary files: doc1.awk & doc3.awk.
  37.  
  38.   2) Some shells did not handle things like "@ cnt2++ " correctly.
  39.      Variable names were changed where appropriate.
  40.  
  41. =====================================================
  42.  
  43. Greetings,
  44.  
  45. This is a the second public release of Doc - Version 2.1.
  46. Doc (domain obscenity control) is a program which diagnoses
  47. misbehaving domains by sending queries off to the appropriate
  48. DNS nameservers, and performing simple analysis on the responses.
  49.  
  50. IMPORTANT: Doc requires version 2.0 of the DNS query tool `dig`
  51.            (domain internet groper).
  52.  
  53. Files contained in this distribution:
  54.  
  55. README       - You're looking at it.
  56. INFO         - Documents current procedure
  57. doc.8        - man page
  58. doc.txt      - ASCII man page
  59. doc          - Shell script for automated domain test
  60. doc1.awk     - simple awk file used by `doc`
  61. doc3.awk     - simple awk file used by `doc`
  62. doc4.awk     - simple awk file used by `doc`
  63. RFC.XXXX     - Draft of RFC about Automated Domain testing
  64. log.isi.edu. - Sample run for isi.edu. domain
  65.  
  66.  
  67. Required files NOT in the distribution:
  68.  
  69. Dig (Version 2.0) - DNS query program required to run `doc`
  70.                     Available via anonymous ftp from:
  71.                     venera.isi.edu.  pub/dig.2.0.tar.Z
  72.  
  73.  
  74. SETUP/CONFIGURATION
  75.  
  76. 'Doc' is a csh script, so no complex porting effort will be required.
  77. Other than the first few aliases and pointers to directories that you
  78. will edit in the 'doc' shell file itself, no changes should be necessary.
  79.  
  80.  
  81. Doc-V.2.1 is an initial implementation of an automated domain testing
  82. tool.  We expect considerable design modification and implementation
  83. changes to be made as experience is gained through use in the
  84. Internet.  At some point, we expect the design to stabilize and a
  85. production version, implemented in something other than the current
  86. UNIX-tool patchwork, to be released.
  87.  
  88. Comments and discussion are very much welcome.
  89.  
  90. Brad Knowles (brad@his.com)
  91.